COMMENT ⊗   VALID 00005 PAGES
C REC  PAGE   DESCRIPTION
C00001 00001
C00002 00002	FILEX
C00005 00003		EACH OF THE FOLLOWING CORE IMAGE FORMATS IS INDICATED BY 
C00008 00004		IF THE OUTPUT NAME OR EXT ARE MISSING, ALMOST THE SAME OCCURS
C00011 00005	SUMMARY OF FILEX SWITCHES
C00014 ENDMK
C⊗;
FILEX

	FILEX IS A GENERAL FILE TRANSFER PROGRAM, INTENDED TO CONVERT
	BETWEEN VARIOUS CORE IMAGE FORMATS AND TO READ AND WRITE
	VARIOUS DECTAPE DIRECTORY FORMATS, AS WELL AS STANDARD DISK
	FILES.

	THE COMMANDS TO FILEX ARE SIMILAR TO A PIP COMMAND STRING.  
	FILES ARE TRANSFERRED AS 36-BIT BINARY DATA.  NO PROCESSING
	IS DONE ON THE DATA ITSELF, EXCEPT THAT NECESSARY TO CONVERT
	BETWEEN VARIOUS CORE IMAGE REPRESENTATIONS.

	RAPID TAPE PROCESSING, VIA A DISK SCRATCH FILE, IS AVAILABLE.

	"WILD-CARD" FILE NAMES (*) ARE PERMITTED.

	DEVICE FORMATS AVAILABLE:

	NON-DECTAPE DEVICES ARE READ AND WRITTEN IN BINARY.  DEVICE,
	FILE-NAME, EXTENSION, PROJECT-PROGRAMMER NUMBER, AND PROTECTION
	ARE SUPPLIED IN THE USUAL WAY.

	DECTAPES IN THE USUAL PDP10 DIRECTORY FORMAT MAY BE READ OR
	WRITTEN IN BINARY IN THE USUAL WAY, AND THEY MAY BE READ VIA
	A DISK SCRATCH FILE, WHICH IS MUCH FASTER FOR EITHER A TAPE
	WITH MANY FILES, OR A TAPE WHICH HAS BEEN WRITTEN BY TENDMP
	(WITH CONSECUTIVE BLOCKS ALLOCATED TO THE SAME FILE.)

	SIMILARLY, DECTAPES MAY BE READ, WITH OR WITHOUT USE OF A
	SCRATCH FILE, AND MAY BE WRITTEN, IN EITHER THE OLD DEC PDP-6
	DECTAPE FORMAT, OR THE MIT PROJECT MAC PDP6/10 DECTAPE FORMAT.
	FOR BOTH OF THESE FORMATS, THE MONITOR'S DECTAPE SERVICE 
	ROUTINE CANNOT BE MADE TO RUN EFFICIENTLY, SO THE SCRATCH
	FILE TECHNIQUE IS ADVISED.  THE /O (OLD) AND /M (MAC) SWITCHES
	SPECIFY THESE FORMATS.  /T (TEN) RETURNS TO PDP10 FORMAT TAPES.

	DATA FORMATS AVAILABLE:

	UNLESS ONE OF THE FOLLOWING SPECIAL FORMATS APPLIES, ALL FILES
	ARE TRANSFERRED UNMODIFIED, AS 36-BIT BINARY DATA.

	CORE IMAGE FILES ARE THE SPECIAL CASES HANDLED.  PROCESSING IS
	AVAILABLE TO CONVERT FROM ANY OF THE FOLLOWING FORMATS TO
	ANY OTHER OF THEM.  (OF COURSE, IF THE INPUT AND OUTPUT FOR-
	MATS ARE IDENTICAL, THE FILE IS SIMPLY COPIED.)
	EACH OF THE FOLLOWING CORE IMAGE FORMATS IS INDICATED BY 
	SPECIFIC EXTENSIONS, WHICH MAY BE OVERRIDDEN BY SWITCHES.

	1)  SAVE-FILE FORMAT:  ASSUMED FOR FILES WITH EXTENSIONS 
	.SAV, .LOW, AND .SVE.  CAN BE FORCED BY THE /C SWITCH (COM-
	PRESSED CORE IMAGE.)  THE DEFAULT OUTPUT EXTENSION FOR A /C
	FILE IS .SAV.

	2)  EXPANDED CORE IMAGE FILE (AS USED BY FILDDT):  ASSUMED
	    FOR FILES WITH EXTENSION .XPN.  CAN BE FORCED BY THE /E
	     SWITCH (EXPANDED).  THE DEFAULT OUTPUT EXTENSION FOR A
	    /E FILE IS .XPN.

	3)  DUMP FORMAT (OLD PDP6 VERSION OF SAVE):  ASSUMED FOR FILES
	    WITH EXTENSION .DMP.  CAN BE FORCED BY THE /D SWITCH.

	4)  SBLK FORMAT (SIMPLE BLOCK-PROJECT MAC'S EQUIVALENT OF
	    DEC'S .SAV FORMAT):  NOT ASSUMED FOR ANY EXTENSION, BUT 
	    IS FORCED BY THE /S SWITCH.  THE DEFAULT OUTPUT EXTENSION
	    FOR A /S FILE IS .BIN.

	5)  THE /B SWITCH CAUSES BINARY PROCESSING EVEN THOUGH A FILE
	    FILE HAS ONE OF THESE SPECIAL EXTENSIONS.

	COMMAND FORMAT:

	A FILEX COMMAND IS OF THE FORM:

		* OUTPUT SPECIFIER ← INPUT SPECIFIER(S)
				OR
		* OUTPUT SPECIFIER = INPUT SPECIFIER(S)
				OR
		/K ← INPUT SPECIFIER (S)

	OUTPUT SPECIFIER IS:

		DEV:  NAME .EXT [P,PN]<PROT>/S  OR ...(S(1)S(2)S(3))
		WHERE /S INDICATES ANY SWITCH

	INPUT SPECIFIER IS:

		DEV:  NAME .EXT [P,PN]/S, ...  OR
		DEV:  [P,PN]/S NAME .EXT, NAME2 .EXT, ...

	IF THE [P,PN] AND/OR /S APPEAR AFTER A DEVICE, THEY APPLY
	TO ALL FOLLOWING FILES.  IF THEY APPEAR AFTER A FILE NAME, THEY
	APPLY ONLY TO THAT FILENAME.

	THE INPUT NAME OR EXT MAY BE *, IN WHICH CASE THE USUAL WILD-
	CARD PROCESSING OCCURS.

	THE OUTPUT NAME OR EXT MAY BE *, IN WHICH CASE THE NAME OR
	EXT OF THE INPUT FILE IS COPIED.

	IN THE CASE OF THE /K FORMAT, THE INPUT SPECIFIERS MUST INDICATE
	PDP11 FILES, I.E. USE THE /V SWITCH.  THIS FORMAT IS USED TO DELETE
	THE SPECIFIED FILES.
	IF THE OUTPUT NAME OR EXT ARE MISSING, ALMOST THE SAME OCCURS
	AS FOR *, EXCEPT THAT ALL CORE IMAGE FILES WILL BE WRITTEN 
	WITH THE DEFAULT EXTENSION AND FORMAT APPROPRIATE TO THE OUT-
	PUT DEVICE (UNLESS OVERRIDDEN BY SWITCHES).  THAT IS,:

		*DSK:  ←DTA1:  FOO.DMP/O  WOULD CAUSE

	THE DMP FORMAT FILE TO BE COMPRESSED /C AND WRITTEN AS FOO.SAV.

	TO CAUSE AN INPUT DECTAPE TO BE PROCESSED QUICKLY (VIA A SCRATCH
	FILE), USE THE /Q SWITCH (FOR QUICK).

	TO CAUSE THE /Q PROCESSING AND PRESERVE THE SCRATCH FILE AFTER
	PROCESSING, FOR USE BY ANOTHER COMMAND, USE THE /P (PRESERVED
	QUICK) SWITCH.

	TO REUSE A SCRATCH FILE PRESERVED BY /P IN A PREVIOUS COMMAND,
	USE THE /R (RE-USE) SWITCH.

	TO IGNORE READ ERRORS ON THE INPUT DEVICE, USE THE /G (GO ON)
	SWITCH.

	FILEX CHECKS THE ALWAYS-BAD-CHECKSUM BIT IN THE LEVEL D DISK
	FORMAT, SO /G IS NOT NEEDED FOR THOSE FILES WITH .RPABC ON
	(E.G. CRASH.SAV).

	TO COPY A CRASH.SAV TO AN EXPANDED FORMAT FILE FOR FILDDT TO
	EXAMINE, TYPE (FOR EXAMPLE):

		DSK:  SER105.SAV[1O,1O]/E←DSKC:  CRASH.SAV[1,4]

	WHILE LOGGED IN AS [1,2] (TO BE ABLE TO READ CRASH.SAV, WHICH
	IS READ-PROTECTED BY THE REFRESHER).

	THE /Z SWITCH ON AN OUTPUT FILE, IF IT IS A DECTAPE, CAUSES
	THE APPROPRIATE FORMAT OF ZEROED DIRECTORY TO BE WRITTEN
	ON THE TAPE.  IF THE STRING

		↑TAPEID

	APPEARS IN THE OUTPUT SPECIFIER, THEN TAPEID IS WRITTEN AS
	THE TAPE IDENTIFIER IN THE DIRECTORY.  TAPEID MAY BE 6 CHA-
	RACTERS ON A PDP10 TAPE, 3 CHARACTERS ON A PROJECT MAC TAPE,
	AND IS NOT PRESENT ON A PDP6 TAPE.

	THE /L SWITCH ON AN INPUT DECTAPE FILE CAUSES THE TAPE DIREC-
	TORY TO BE TYPED ON THE TTY.  (DO NOT PUT TTY: IN THE OUTPUT 
	FILE SPECIFIER.  THAT WOULD TRY TO WRITE FILES ON THE TTY IN 
	BINARY.)
SUMMARY OF FILEX SWITCHES

	SWITCH	MEANING				DEFAULT EXTENSION

	1.  DEC TAPE FORMAT SPECIFIERS

	    M -	MAC
	    O -	OLD, PDP-6
	    T -	TEN; NORMAL PDP-10 DIRECTORY FORMAT
	    V - (EleVen) PDP-11 DIRECTORT FORMAT

	2.  FILE FORMAT SPECIFIERS

	    A - ASCII
	    B -	BINARY; OVERRIDES DEFAULT EXTENSION
	    C -	COMPRESSED; SAVED FILE FORMAT	SAV
						LOW
						SVE
	    D -	DUMP; OLD PDP-6			DMP
	    E -	EXPANDED; FOR FILDDT		XPN
	    I - IMAGE
	    S -	SBLK; PROJECT MAC'S SAVE	BIN

	3.  DEC TAPE PROCESSING SWITCHES

	    G -	GO ON; IGNORE READ ERRORS
	    L -	LIST; TYPE DIRECTORY ON TTY
	    P -	PRESERVED; Q PLUS KEEP FILE
	    Q - QUICK; USE SCRATCH FILE FOR DIRECTORY
	    R -	REUSE; SCRATCH DIRECTORY FROM P
	    Z - ZERO;	DECTAPE DIRECTORY
	    ↑N(1)...N(6)- SPECIFY TAPE IDENTIFIER